home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / PD_THEMA / KOPIEREN / MDISK61 / MDISK61.DOC < prev    next >
Text File  |  1998-03-14  |  23KB  |  516 lines
  1. Documentation for M-Disk 6.x for Atari ST
  2. =========================================
  3.  
  4. M-Disk provides
  5.   - a sizable removable multi-function ramdisk
  6.   - a floppy disk copy program (with virus detection logic)
  7.   - a fast ramdisk load/save program
  8.   - a harddisk backup/restore program
  9.   - a PS/2 compatible floppy disk formatting program
  10.   - a boot sector virus destruction program
  11. all in one program.
  12.  
  13. What's NEW:
  14. ===========
  15.  
  16. Version 6.1: - Try to improve TT compatibility
  17.              - some internal clean up
  18.  
  19. Version 6.0: - New GEM dialog: Setting of format parameters is now inside
  20.                the main dialog. Faster GEM dialog handling.
  21.              - Adapted to speed boards, 68030, etc.
  22.              - Adapted to TT (and it's brain damaged ``fast RAM'').
  23.              - Formatting is much faster under MiNT now !
  24.              - Verify may be turned off (Harakiris will like this).
  25.              - The `Format selection' button (see below !!)
  26.              - The `Clear M-Disk' button.
  27.              - When the selected format for `save+format' is too small,
  28.                M-Disk can do automatic format extension
  29.              - Support for disk labels.
  30.  
  31. Version 5.97: Some internal cleanup. M-Cache no longer included in the
  32.               distribution.
  33.  
  34. Version 5.96: Copy button as shorthand for load + save
  35.  
  36. Version 5.95: Set the mouse into the dialog
  37.  
  38. Version 5.9: Many wonderful new features:
  39.              - Optional reset resident M-Disk
  40.              - Optional auto-installing M-Disk
  41.              - Optional support for TEMPLMON user trace vector
  42.              - Optional automatic check of a magic number on every disk access
  43.                ==> You may get disk error dialog boxes now on the Ram Disk !!!
  44.  
  45. Since Version 4.x M-Disk does not use any undocumened variables. It should work
  46. with any TOS Version. Tested with Disk TOS 1.0 (1986), TOS 1.6 (STE TOS),
  47. KAOS 1.4.1, and MiNT 0.71.
  48.  
  49. M-Disk 6.0 should work with all known Atari ST harware configurations including
  50. 16-MHz-boards, 68030 Boards, STE, TT, etc.
  51.  
  52. Notes about Cache: Old M-Disk Versions included a simple cache. In Version 5.8
  53.   this went into the separate program M-Cache. M-Cache did never work, since it
  54.   accidently forgot to install itself. I do no longer include M-Cache because:
  55.   a) The cache does not check for media changes and thus has problems with
  56.      media changes like in the Atari Megafile 44.
  57.   b) The cache layout was for a fixed sector size of 512 Bytes, but did not
  58.      check this. So it did not work with the new big Partitions of AHDI 3.0.
  59.   c) Nowadays nearly everybody has TOS 1.4. Use CACHE100.PRG in the AUTO folder
  60.      and this will be better and give you less problems than most cache programs
  61.      floating around.
  62.   d) I could adapt M-Cache to AHDI 3.0 and Megafile 44, but I don't have the
  63.      time in the moment and since one may well use CACHE100, there is no more
  64.      reason for having a separate cache program.
  65.   e) If you don't have TOS 1.4 (or above) you should hurry to get it.
  66.  
  67. Mixed hints:
  68.   - do *always* have POOLFIX3.PRG in the AUTO folder when using TOS 1.4 or 1.6.
  69.   - do *always* have FOLDR100.PRG in the AUTO folder when using TOS 1.4 or 1.6.
  70.   - do *never* use the buggy TURBODOS.
  71.   - do *not* use CACHExxx.PRG with old TOS Versions (below 1.4).
  72.   - do *not* use the cache of the old M-Disk versions on Partitions that are
  73.     bigger than 15 MB.
  74.   
  75. Included files:
  76. ===============
  77.  
  78.     NAME           Length       Comment
  79.  
  80.   - MDISK.ACC       26748       the program
  81.   - MDISK6xx.DOC    22717       this document; Version = 6.xx
  82.   - CLEAR_M.PRG        78    utility program for old TOS versions
  83.  
  84. Installing the RamDisk:
  85. =======================
  86.  
  87. Move MDISK.ACC to the root directory of your boot disk, then reboot.
  88. Now there's a Desk Accessory entry "M-Disk" that lets you select
  89. a size for your ramdisk. Enter a size, then click "Install". Now M-Disk
  90. is active. Install a disk Icon for M-Disk, so you can click on it. M-Disk
  91. is always on drive M.
  92.  
  93. M-Disk can now be used like any normal RAM disk.
  94.  
  95. Copying from/to the M-Disk:
  96. ===========================
  97.  
  98. Since Floppy Disks are soooooo slow there is an option to load/save a whole
  99. Floppy Disk at once. This will make a plain copy of all files an directories,
  100. destroying the whole prior contents. The serial number of the Disk however
  101. is not changed.
  102.  
  103. >>>> The load/save option actually is the clou of the program.
  104. >>>> Use it often, it will save you lots of time.
  105. >>>> 
  106. >>>> load/save only works for Ram Disk size <= 1700 k !
  107.  
  108. Use as Disk Copier:
  109. ===================
  110.  
  111. First load the source disk into M-Disk, then save onto the target disk.
  112. Most common floppy formats are supported. The formats of the source and
  113. target disks need not be the same, so you can quick and easy copy
  114. a single sided disk to a double sided or IBM PS/2 or 800 KB Disk. You may
  115. even copy a double sided to a single sided disk if the target disk has
  116. enough space.
  117.  
  118. If the target disk is unformatted or you want to reformat it into fast format
  119. use the "+ format" button. The format options are used then to select a format
  120. for the disk to write.
  121.  
  122. If you want to make more than one copy you may want to use the 'copy' button.
  123. This allows you to make up to three copies and thus is equivalent to pressing
  124. first 'load' and then 'save' one to three times for each original to copy.
  125.  
  126. The 'copy' button is a true equivalent of 'load'+'save': After the 'copy'
  127. operation the new RamDisk contents are still intact and may be used for
  128. further operations.
  129.  
  130. Use as Backup Program:
  131. ======================
  132.  
  133. Backup:
  134.   You probably won't Backup the whole Hard disk at once. So select the
  135.   part you want to save, then install an M-Disk that is big enough to
  136.   hold your data. If you make it small enough to fit on your floppy disk
  137.   you can copy files from the Harddisk to M-Disk until M-Disk is full.
  138.   Now save the data with the "save" option onto a floppy.
  139. Restore:
  140.   Load your Backup Disk into M-Disk (with "load disk"). Then copy the files
  141.   from M-Disk to your Hard Disk. This is *much* faster than copying
  142.   directly from floppy to harddisk.
  143. Incremental Backup:
  144.   Load your (old) backup floppy into M-Disk. Delete some files, copy new
  145.   versions from the harddisk to M-Disk. When your finished save the result
  146.   again onto your floppy.
  147.  
  148. Use as fast Ramdisk load/save program
  149. =====================================
  150.  
  151. Don't you think loading files from floppy to your (reset resident,
  152. auto-compressing, super-hyper) Ram-Disk needs a little speed up ?!?
  153.  
  154. Here it is:
  155.  
  156. After having installed your Ram-Disk you install M-Disk, then load
  157. from floppy to M-Disk (with M-Disk's "load"). Now you copy everything
  158. as usual file-by-file to your Ram-Disk. You may kill M-Disk thereafter.
  159.  
  160. Saving your work when you are finished is just the other way round:
  161. Copy file-by-file to M-Disk, then use M-Disk's "save".
  162.  
  163. Formatting floppy disks
  164. =======================
  165.  
  166. You may format a disk at any time. Among the various formats that can
  167. be formatted there are two MSDOS compatible formats:
  168.  
  169. - 80 tracks, 2 sides, 9 sectors: The standard 3.5" PS/2 format.
  170. - 40 tracks, 2 sides, 9 sectors: The standard 5.25" MSDOS/PCDOS format.
  171.  
  172. These two formats are at least "300% compatible", i. e. the logical disk
  173. structure is 100% compatible, the boot sector and media byte is 100% compatible
  174. and the physical disk structure (GAPs between sectors etc.) is 100% compatible.
  175. Of course you cannot boot your PS/2 computer from an Atari formatted disk.
  176.  
  177. While remaining compatible the disks formatted with M-Disk still run fast
  178. on the ST. Since M-Disk Version 4.0, they also run fast on the PC.
  179.  
  180. The `+format' button
  181. ====================
  182.  
  183. When the `+format' button is active (dark) M-disk formats all the disks
  184. on-the-fly while writing out a disk from a `save' or `copy' command.
  185. This saves an additional format run if you want to write unformatted disks.
  186.  
  187. It's also wise to reformat floppys from time to time if they
  188. - were not formatted on the same drive on which they are to be used.
  189. - have not been formatted for a long time. As the years go by, floppy disks
  190.   may loose their formatting information.
  191.  
  192. The verify flags
  193. ================
  194.  
  195. M-Disk verifies every operation. For this reason no quick- or superquick-
  196. formatting routines are possible. Routines that format a 80 Track double
  197. sided disk in under 1 minute must time out the controller before each track
  198. is competely written. This leaves some garbage at the end of each track.
  199. If you are unlucky you would get another valid sector header in this area.
  200. So you might get e.g. "sector 1" two times on one track. Now these two
  201. will be read/written by TOS randomly, causing big problems. So M-Disk
  202. does not use these quick-and-dirty routines but always formats till the
  203. end of track assuring no anomaly can occur (additional verify is done also).
  204.  
  205. Since M-Disk 6.0 the verify on 'format' and 'format+save' can be turned off.
  206. There may be some people out there who want to speed up writing at the
  207. risk of damaged disks. For the 'save' button without '+format' the normal
  208. TOS routines are used. Verify is then controlled by the TOS verify flag
  209. which is turned ON by default.
  210.  
  211. There is one thing that M-Disk cannot verify: When you are formats with
  212. more than 80 tracks your head (floppy disk head, not yours) may run against
  213. the wall. You hear a click. On normal formatting programs this will result
  214. in a misplaced last track (slightly off correct position). But M-Disk starts
  215. formatting at the last track. So if you hear this click with M-Disk *all*
  216. tracks will be formatted on incorrect place.
  217.  
  218. ***         For this reason you should formats over 80 tracks only
  219. ***         if you are absolutely sure that your floppy can hold this
  220. ***         without running its head against the wall.
  221.  
  222. The normal TOS formatted disk speed is rather slow. M-Disk formats standard
  223. fast-runing disks like DCFORMAT, FCOPY, CopyStar etc.
  224.  
  225. If you format/write 40-track disks on a 80-tracks double-stepping disk drive
  226. it's wise to write the data several times if you later want to read it on
  227. 40-track disks (e.g. press `save' with `+ format' several times).
  228.  
  229. The `Format selection' button
  230. =============================
  231.  
  232. When the `Format selection' button is turned off (white) M-Disk automatically
  233. sets the Format parameters to those found on the disk on every `load'
  234. operation. This is especially useful with the `copy' button when used
  235. together with `+format':
  236.  
  237. - When `Format selection' is active (dark) all copies are formatted in the
  238.   pre-selected way.
  239. - When `Format selection' is inactive (white) all copies are formatted in
  240.   the format that was found on the corrosponding original.
  241.  
  242. The automatic format extension
  243. ==============================
  244.  
  245. When the selected format for `save+format' (or `copy+format') is too small
  246. but it's possible to make up a format that fits, M-Disk will ask you
  247. if you want to extend the current format.
  248.  
  249. As a consequence when copying floppy disks with `copy' you may select a small
  250. format for the standard, make `Format selection' active, and copy all of the
  251. disks onto standard-formatted disks until you get to a disk that is too big
  252. for it. When using the automatic format extension only those big disks will
  253. be formatted in the bigger format.
  254.  
  255. Exercise (easy): What happens with the automatic format extension when you
  256. `copy+format' with `Format selection' inactive?
  257.  
  258. Wiping disks
  259. ============
  260.  
  261. The `wipe' function only clears the FATs and the root directory of the
  262. specified device. This is much faster than erasing every single file or
  263. reformatting the disk. `wipe' can also be applied to non-floppy media
  264. (e.g. M:). M-Disk will not wipe media with 12-Bit FATs or more than
  265. 5 FAT sectors without an additional reconfirmation dialog.
  266.  
  267. Wipe is activated by clicking on one of the `Label' drives while the
  268. `CONTROL' or `SHIFT' key is pressed. So this function is somewhat hidden.
  269.  
  270. Disk labels
  271. ===========
  272.  
  273. Support for disk labels was added although GEMDOS does not support them
  274. very well. You can, however, see the disk label in the `Show info' dialog
  275. applied to a disk.
  276.  
  277. Disk labels produced by PC-DOS will show up in the directory because
  278. GEMDOS does not allow the archive bit with disk labels but PC-DOS seems
  279. to set it.
  280.  
  281. In old TOS versions disk labels can only be removed again via a trick (which
  282. M-Disk uses: Create a plain file with the label's name, then delete this
  283. file).
  284.  
  285. Since TOS 1.4 disk labels can never be removed so M-Disk must use another
  286. trick here (create a label with the strange name "\xE5").
  287.  
  288. Since disks without labels do well there is normally no need to use disk
  289. labels.
  290.  
  291. The `Clear M-Disk' button
  292. =========================
  293.  
  294. The small button that looks like a `window closer' provides a function to
  295. quickly clear the M-Disk. This is similar to do `wipe' on disk `M:'.
  296.  
  297. What floppy Disk format should I use ?
  298. ======================================
  299.  
  300. The 2 sides 80 track 9 sector format is the normal (and fastest) format.
  301. Use this whenever you do not need extremly much space on disk.
  302.  
  303. 10 sector format is safe. You may well use this whenever you want some
  304. more space on the disk. 10 sector disks run a little slower than 9 sector
  305. disks.
  306.  
  307. 11 sector format may only be used if your floppy disk drive is not too fast
  308. and do not use some cheap and bad disks. 11 sector disks run a little slower
  309. than 10 sector disks. It is normally better to use 11 sector formats than
  310. to format over 80 tracks.
  311.  
  312. Formats over 80 tracks may not run on some disks and (much more evil)
  313. on some drives. So if it all works on your disk drive carry the disk to
  314. a friend and (s)he maybe will not be able to read the additional tracks.
  315. If the floppy disk head hits its limit while formatting you yourself
  316. may eventually not be able to read the disks on your own system. So use
  317. this option seldom or never.
  318.  
  319. 40 track disks can be used for special applications e.g. formatting
  320. IBM PC-DOS compatible 5.25 inch floppies. You will not need this for your
  321. normal work with the ST.
  322.  
  323. Customizing M-Disk
  324. ==================
  325.  
  326. You may want to set up your own startup-defaults for M-Disk. To do this,
  327. make the drive containing M-Disk the actual drive (e.g. Top window),
  328. enter the value for `Ram Disk size' you want as the default value,
  329. then click `setup'.
  330.  
  331. Set the preferences you like. The `user trace' option sets up a user
  332. trace vector for the TEMPLMON monitor. This user trace checks the
  333. validity of the RAM disk and may thus be useful in finding the critical
  334. point in a bad program that corrupts the M-Disk buffer.
  335.  
  336. At last, click `save setup'. The setup is then saved to MDISK.ACC on
  337. the root of the current active drive (i.e. current window in desktop).
  338.  
  339. Strike the Virus out !
  340. ======================
  341.  
  342. When you use normal Disk-Copy Programs you may get a boot sector virus
  343. onto the copy disk. This is due to the fact that normal disk copy programs
  344. copy the boot sector as it is onto the copy disk. So any virus on the original
  345. gets copied to the copy.
  346.  
  347. M-Disk however does not copy the boot sector. So boot a sector virus does not
  348. get copied when copying disks with M-Disk. For this reason M-Disk copies
  349. are more safe.
  350.  
  351. M-Disk version 5.5 (and up) has an additional virus detection logic that
  352. detects executable boot sectors on every disk operation. You get messages of
  353. 2 levels:
  354.  
  355. 1. "Bootsector executable. This may be a virus or bootable program."
  356.    This message is no reason to panic. There is an executable boot sector
  357.    on the disk. This can be a virus, but it can also be startup code for a
  358.    game, time-setting, hard-disk related or other programs. Before destroying
  359.    it, you should test it with a more sophisticated virus destruction program
  360.    or the procedure described below.
  361.  
  362.    Conclusion: In this first case, you do not know, if you have a virus.
  363.  
  364. 2. "*** Attention: VIRUS ***   Your system is infected !".
  365.    Now you should be in panic !!! You booted with a virus-infected disk and
  366.    probably all disks, that have been in your floppy drive since the last
  367.    re-boot are infected now ! Let's hope you did not loose data !
  368.  
  369.    You should destroy the virus now (with the "virus check" button),
  370.    write-protect that disk and do a coldboot with this now virus-free
  371.    disk inserted in the floppy drive. Pressing the reset button
  372.    is not sufficient in this case. You must turn your computer off,
  373.    wait for 10 seconds, and turn it on again with a non-infected disk
  374.    in the drive. If you have TOS 1.4 and think CTRL-ALT-SHIFT-DEL is
  375.    sufficient please note that a virus may catch this vector !
  376.  
  377.    Conclusion: In this second case, you do absolutely sure have a virus !!!
  378.  
  379. (3. You see no message. Then you probably don't have a boot sector virus,
  380.     but you may have a link virus or something else.)
  381.  
  382. Test: Do I have a boot sector virus ?
  383. =====================================
  384.  
  385. If you are not sure if a particular boot sector on some disk is a virus,
  386. you can test it with the following procedure:
  387.  
  388. 1. Copy MDISK.ACC to the suspicious disk. Turn off the hard disk (we do
  389.    not want trouble on it). Put the suspicious disk in floppy drive A: and
  390.    press the reset button.
  391.  
  392. 2. Take an unformatted disk, format it with M-Disk, then wipe it, load
  393.    something into the M-Disk, then copy the M-Disk onto the newly formatted
  394.    disk with M-Disk save. Load and save again, etc. When you see the message:
  395.        "*** Attention: VIRUS ***   Your system is infected !".
  396.    somewhere in this process, you know, that you definitely have a virus.
  397.  
  398.    When you don't see that message, you may or may not have a virus.
  399.  
  400. Little virology
  401. ===============
  402.  
  403. There are many virus types in the world. M-Disk only recognises the most
  404. harmless (but also most common) type: "boot sector virus".
  405. This virus type sits in the boot sector and gets loaded whenever you boot
  406. with an infected disk in the boot drive.
  407.  
  408. A boot sector virus can easily be found and destroyed. If you copy all your
  409. data only with M-Disk (Version 5.5 and up), you will probably never have
  410. trouble with any "boot sector" type virus.
  411.  
  412. More trouble comes with the "link virus" type, which is not recognised by
  413. M-Disk. A link virus links itself to any program, therefore it can never be
  414. found in the boot sector. It comes to your system along with some new program
  415. and as time goes by infects all of your programs. Whenever you start one of
  416. your programs now, you activate the virus.
  417.  
  418. All virus programs reproduce themselves. But that's not all. There are some,
  419. that give funny messages on the screen, some that produce bombs from time to
  420. time, some destroy data on your floppy or hard disk, some destroy your monitor
  421. or floppy disk drive etc. So take care to eliminate every virus as soon as
  422. possible.
  423.  
  424. There are also some special boot sector virus types that destroy everything
  425. they find in the boot sector (sometimes called anti-virus) and dummy boot sector
  426. programs (sometimes called virus protection programs). I don't like the concept
  427. of the anti-virus because it is just another virus and you never know what's
  428. going on in your floppy drive. I prefer a clean boot sector i. e. one that
  429. is filled up with zeroes after the first 30 Bytes of disk information.
  430.  
  431. Care for executable boot sectors
  432. ================================
  433.  
  434. Some disks (especially some games) have executable boot sectors. These sectors
  435. cannot be copied with M-Disk. Use other Programs to copy those disks.
  436. M-Disk will warn you whenever it detects an executable boot sector
  437. because this could also be a virus.
  438.  
  439. Copy protected disks
  440. ====================
  441.  
  442. M-Disk cannot copy copy-protected software.
  443.  
  444. Recognise disk changes !
  445. ========================
  446.  
  447. When making backups of your data disk with normal disk copy programs
  448. the boot sector is copied as it is. This results in two 100% identical disks.
  449. The problem now is that the serial number of these two disks is the same.
  450. TOS uses this serial number to detect disk changes.
  451.  
  452. So if you now swap between these two disks TOS does not notice any disk change
  453. and you may get strange results i. e. lots of garbage on your disk. This
  454. may go up to complete data loss.
  455.  
  456. With M-Disk copy this won't happen since every disk gets a new serial number
  457. and so TOS will recognise every disk change correctly.
  458.  
  459. CLEAR_M.PRG
  460. ===========
  461.  
  462. Old TOS Versions (pre 1987) don't clear the _drvbits system variable on reset
  463. time. For proper work with M-Disk, those Systems should have CLEAR_M.PRG
  464. in the AUTO folder of the boot disk. TOS Versions of 1987 and later do not
  465. need this.
  466.  
  467. WARNING:
  468. ========
  469.  
  470. TurboDos had Problems with older M-Disk Versions. Versions >= 3.1 were
  471. not tested with TurboDos but it may eventually work together.
  472. (TurboDos is very buggy so you shouldn't use it anyway.)
  473.  
  474. There's no need to use M-Disk with TurboDos. Use FATSPEED and you will get
  475. TurboDos speed without TurboDos. Since M-Disk Version 5.5 FATSPEED is no 
  476. longer included in this distribution. You can get it from various sources,
  477. but you should better get the TOS 1.4 ROMs of April 6, 1989 (Rainbow TOS)
  478. into your computer.
  479.  
  480. Be sure to always use POOLFIX3.PRG with TOS 1.4 and TOS 1.6 (STE TOS).
  481. This program fixes (or at least tries to fix) the 40-folder bug, that was
  482. fixed and simultaneously re-introduced in TOS 1.4.
  483.  
  484. Disclaimer:
  485. ===========
  486.  
  487. WARNING: I'm using this program every day but I do not make any warranty
  488.          with respect to this documentation and the program it describes.
  489.          I disclaim any implicit/explicit suggestions of usefulness for any
  490.          particular purpose. I will not be responsible for any damages or
  491.          data lossage caused by using this program. If you want to use it
  492.          use it at your own risk.
  493.  
  494. This Program may be used and distributed freely as long as the program is
  495. left unchanged and this documentation goes unchanged with it.
  496. It may not be sold.
  497.  
  498. M-Disk was compiled with the new Lattice C 5.06.01 with a few Assembler
  499. subroutines.
  500.  
  501. For the rare case, that anybody wants to send me a little donation, here's the
  502. place where you can put it:
  503. 'Nr. 2197 04-507' at the 'Postgiroamt Koeln', 'BLZ 370 100 50' (Germany).
  504.  
  505. My adress until the mid of 1991 is:
  506.  
  507.   Christoph Strunk
  508.   Wartburgstr. 10
  509. D-4630 Bochum 7
  510.   (Federal Republic of Germany)
  511.  
  512.  
  513. P.S.: The answer to above exercise is: You will never see it.
  514.  
  515. - End of Document -
  516.